From 5034920f7809181bcfaf4d84ef9b8e1fabf0fb9f Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Fri, 24 Jan 2014 20:15:10 -0500 Subject: [PATCH] Deprecate gtk_widget_get_root_window The root window is a fairly X-centric concept, and it really has no place in the GtkWidget API. Plus, this is a rarely-used one-line convenience function with poor documentation. --- gtk/gtkwidget.c | 4 +++- gtk/gtkwidget.h | 2 +- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c index 896ff398e6..f4246ac7cc 100644 --- a/gtk/gtkwidget.c +++ b/gtk/gtkwidget.c @@ -10177,7 +10177,9 @@ gtk_widget_get_display (GtkWidget *widget) * Return value: (transfer none): the #GdkWindow root window for the toplevel for this widget. * * Since: 2.2 - **/ + * + * Deprecated: 3.12: Use gdk_screen_get_root_window() instead + */ GdkWindow* gtk_widget_get_root_window (GtkWidget *widget) { diff --git a/gtk/gtkwidget.h b/gtk/gtkwidget.h index 0a657a7421..1f6318f6e9 100644 --- a/gtk/gtkwidget.h +++ b/gtk/gtkwidget.h @@ -1010,7 +1010,7 @@ GDK_AVAILABLE_IN_3_10 gint gtk_widget_get_scale_factor (GtkWidget *widget); GDK_AVAILABLE_IN_ALL GdkDisplay * gtk_widget_get_display (GtkWidget *widget); -GDK_AVAILABLE_IN_ALL +GDK_DEPRECATED_IN_3_12 GdkWindow * gtk_widget_get_root_window (GtkWidget *widget); GDK_AVAILABLE_IN_ALL GtkSettings* gtk_widget_get_settings (GtkWidget *widget); -- 2.30.2